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Foreword 



rd , 



This Technical Specification has been produced by the 3 Generation Partnership Project (3GPP). 

The contents of the present document are subject to continuing work within the TSG and may change following formal 
TSG approval. Should the TSG modify the contents of the present document, it will be re-released by the TSG with an 
identifying change of release date and an increase in version number as follows: 

Version x.y.z 

where: 

X the first digit: 

1 presented to TSG for information; 

2 presented to TSG for approval; 

3 or greater indicates TSG approved document under change control. 

y the second digit is incremented for all changes of substance, i.e. technical enhancements, corrections, 
updates, etc. 

z the third digit is incremented when editorial only changes have been incorporated in the document. 



Introduction 



rd , 



The present document is part of a TS-family covering the 3 Generation Partnership Project; Technical Specification 
Group Services and System Aspects; Telecommunication management; as identified below: 

TS 32.331 "Notification Log (NL) Integration Reference Point (IRP); Requirements" 

TS 32.332 "Notification Log (NL) Integration Reference Point (IRP); Information Service (IS)" 

TS 32.333 "Notification Log (NL) Integration Reference Point (IRP); Common Object Request Broker 

Architecture (CORBA) Solution Set (SS)" 

TS 32.335 "Notification Log (NL) Integration Reference Point (IRP); extensible Markup Language (XML) 

solution definitions" 
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Scope 



The present document specifies the CORBA Solution Set for the IRP whose semantics are specified in 3GPP TS 32.332 
[6] Notification Log IRP: Information Service. 

Clause 1 to 3 provides background information. Clause 4 provides key architectural features supporting the SS. 
Clause 5 defines the mapping of operations, notification, parameters and attributes defined in IS to their SS equivalents. 
Clause 6 describes the notification interface containing the push method. Annex A contains the IDL specification. 

This Solution Set specification is related to TS 32.332 V8.0.X. 



References 



The following documents contain provisions which, through reference in this text, constitute provisions of the present 
document. 

• References are either specific (identified by date of publication, edition number, version number, etc.) or 
non-specific. 

• For a specific reference, subsequent revisions do not apply. 

• For a non-specific reference, the latest version applies. In the case of a reference to a 3GPP document (including 
a GSM document), a non-specific reference implicitly refers to the latest version of that document in the same 
Release as the present document. 

[1] OMG TC Document telecom/98-11-01: "OMG Notification Service". 

http://www.omg.org/technologv/documents/ 

[2] OMG CORBA Services: "Common Object Services Specification, Update: November 22, 1996" 

(Clause 4 contains the Event Service specification), http://www.omg.org/technologv/documents/ 

[3] 3GPP TS 32.3 11: "Telecommunication management; Generic Integration Reference Point (IRP) 

management; Requirements". 

[4] 3GPP TS 32.302: "Telecommunication management; Configuration Management (CM); 

Notification Integration Reference Point (IRP); Information Service (IS)". 

[5] 3GPP TS 32.303: " Telecommunication management; Configuration Management (CM); 

Notification Integration Reference Point (IRP); Common Object Request Broker Architecture 
(CORBA) Solution Set (SS)". 

[6] 3GPP TS 32.332: "Telecommunication management; Notification Log (NL) Integration Reference 

Point (IRP); Information Service (IS)". 

[7] 3GPP TS 32.312: "Telecommunication management; Generic Integration Reference Point (IRP) 

Management; Information Service (IS)". 



3 Definitions and abbreviations 

3.1 Definitions 

For the purposes of the present document, the terms and definitions given in TS 32.332 [6] apply. 
IRP document version number string (or "IRPVersion"): See 3GPP TS 32.31 1 [3] subclause 3.1. 
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3.2 



Abbreviations 



For the purposes of the present document, the following abbreviations apply: 

CORBA Common Object Request Broker Architecture 

IDL Interface Definition Language 

IRP Integration Reference Point 

MOC Managed Object Class 

MOI Managed Object Instance 

NE Network Element 

OMG Object Management Group 



4 Architectural Features 

The overall architectural feature of Notification Log IRP is specified in 3GPP TS 32.332 [6]. This clause specifies 
features that are specific to the CORBA SS. 



4.1 



Notification Services 



In implementations of CORBA SS, IRP Agent conveys Notification Log notifications to IRPManager via OMG 
Notification Service (OMG Notification Service [1]). 

OMG Event Service [2] provides event routing and distribution capabilities. OMG Notification Service provides, in 
addition to Event Service, event filtering and Quality Of Service (QOS). 

A necessary and sufficient subset of OMG Notification Services shall be used to support Notification Log notifications 
as specified in 3GPP TS 32.332 [6]. 

These operation are classified as «AgentInternal-usage» in GPP TS 32.332 [6]. 



5. IVIapping 

5.1 Operation and Notification mapping 

3GPP TS 32.332 [6] defines semantics of operations and notifications visible across the Notification Log IRP. 

The following table indicates the mapping of these operations and notifications to their equivalents defined in this SS. 

Table 5.1.1 : Mapping from IS Notification/Operation to SS equivalents 



IS Operation/ notification 
3GPP TS 32.332 [6] 


SS IVIethod 


Qualifier 


subscribeLog 


subscribe log 


M 


unsubscribeLog 


unsubscribe log 


M 


exportLog Records 


export log records 





getLog Records 


get log records 





getLogSubscriptionlds 


get log subscription ids 





getLogSubscriptionStatus 


get log subscription status 





notifyLogSubscribed 


push_structured_event (note 1). See clause 4.L 
See interface NotifyLogSubscribed 


M 


notifyLogUnsubscribed 


push_structured_event (note 1). See clause 4.L 
See interface NotifyLogUnubscribed 


M 


notifyOccupancyLevelCrossed 


push_structured_event (note 1). See clause 4.L 
See interface NotifyLogOccupancyLevelCrossed 





notifyLoggingResumed 


push_structured_event (note 1). See clause 4.1 . 
See interface NotifyLoggingResumed 





NOTE: OMG Notification Service OIVIG Notification Service [1] defines this method. 
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5.2 Operation parameter mapping 



3GPP TS 32.332 [6] defines semantics of parameters carried in operations across the Notification Log IRP. 

The following tables indicate the mapping of these parameters, as per operation, to their equivalents defined in this SS. 

Table 5.2.1 : Mapping from IS subscribeLog parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


logSubscriptionld 


NotificationLoglRPConstDefs::LogSubscriptionld logSubscriptionld 


M 


loggingEndllme 


GenericlRPManagementConstDefs::IRPTime 
loggingEndlimeAsked 





notificationCategories 


GenericlRPI\/lanagementConstDefs::NotificationCategorySet 
notificationCategorySet 





filter 


GenericlRPManagementConstDefs::StringOpt filter 





logManagerToken 


NotificationLoglRPGonstDefs::LogManagerTokenOpt 
logManagerToken; 





loggingEndTime 


GenericlRPManagementConstDefs::loggingEndTimeGiven 





status 


GenericlRPManagementGonstDefs::Signal 

Exceptions: 

SubscribeLog, GenericlRPManagementSystem::lnvalidParameter, 

GenericlRPManagementSystem::ParameterNotSupported, 

GenericlRPManagementSystem::ValueNotSupported, 

InvalidLogSubscriptionId, UnknownLogManagerToken. 


M 



Table 5.2.2: Mapping from IS unsubscribeLog parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


logSubscriptionld 


NotificationLoglRPGonstDefs::LogSubscriptionld logSubscriptionld 


M 


logManagerToken 


NotificationLoglRPGonstDefs::LogManagerTokenOpt 
logManagerToken 





status 


GenericlRPManagementGonstDefs::Signal 

Exceptions: 

UnsubscribeLog, 

GenericlRPManagementSystem::lnvalidParameter, 

GenericlRPManagementSystem::ParameterNotSupported, 

UnknownLogSubscriptionld, UnknownLogManagerToken). 


M 



Table 5.2.3: Mapping from IS exportLogRecords parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


logSubscriptionld 


NotificationLoglRPGonstDefs::LogSubscriptionld logSubscriptionld 


M 


notificationGategories 


NotificationLoglRPGonstDefs::NotificationGategorySetOpt 
notificationGategorySet 





filter 


GenericlRPManagementGonstDefs::StringOpt filter 





invocationid 


string invocationid 


M 


status 


GenericlRPManagementGonstDefs::Signal 

Exceptions: 

ExportLogRecords, GenericlRPManagementSystem::lnvalidParameter, 

GenericlRPManagementSystem::ParameterNotSupported, 

GenericlRPManagementSystem::OperationNotSupported, 

UnknownLogSubscriptionld. 


M 
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Table 5.2.4: Mapping from IS getLogRecords parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


logSubscriptionld 


NotificationLoglRPConstDefs::LogSubscriptionld 
logSubscriptionld 


M 


notificationCategories 


NotificationLoglRPConstDefs::NotificationCategorySetOpt 
notificationCategories, 





filter 


GenericlRPIVIanagementConstDefs::StringOpt filter 





getLogRecordsResult 


Some or all of the information contained in getLogRecordsResult 
will be returned via the return value of type 
DsLogAdmin::RecordList. 


M 


status 


Exceptions: 

GetLogRecords, 

GenericlRPIVIanagementSystem::lnvalidParameter, 

GenericlRPManagementSystem::ParameterNotSupported, 

GenericlRPI\/lanagementSystem::ValueNotSupported, 

GenericlRPManagementSystem::OperationNotSupported, 

UnknownLogSubscriptionld. 


M 



Table 5.2.5: IVIapping from IS getLogSubscriptionids parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


logSubscriptionlds 


return value of type DsLogAdmin::LogldList 


M 


status 


Exceptions: 

GetLogSubscriptionids, 

GenericlRPI\/lanagementSystem::OperationNotSupported. 


M 



Table 5.2.6: IVIapping from IS getLogSubscriptionstatus parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


logSubscriptionld 


NotificationLoglRPConstDefs::LogSubscriptionld 
logSubscriptionld 


M 


logAttributeLlst 


NotificationLoglRPConstDefs::LogAttributeList logAttributeLlst 


M 


status 


GenericlRPI\/lanagementConstDefs::Signal 

Exceptions: 

GetLogSubscriptionstatus, 

GenericlRPIVIanagementSystem::lnvalidParameter, 

GenericlRPI\/lanagementSystem::OperationNotSupported. 


M 



5.3 Notification parameter mapping 



3GPP TS 32.332 [6] defines semantics of parameters carried in notifications. The following tables indicate the mapping 
of these parameters to their OMG CORBA Structured Event (defined in OMG Notification Service [1]) equivalents. 
The composition of OMG Structured Event, as defined in the OMG Notification Service [1], is: 



Header 



Body 



Fixed Header 

domain_name 

type_name 

event_name 
Variable Header 

f ilterable_body_f ields 
remaining_body 



The following tables list all OMG Structured Event attributes in the second column. The first column identifies the 
3GPP TS 32.332 [6] defined notification parameters. 
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Table 5.3.1 : Mapping for notifyLogSubscribed 



IS Parameters 


OMG CORBA 

Structured Event 

attribute 


Qualifier 


Comment 


There is no 
corresponding IS 
parameter. 


domain_name 


M 


It carries the IRP document version number string. See sub-clause 3.3. 
It indicates the syntax and semantics of the Structured Event as defined by 
this specification. 


notificationType 


type_name 


M 


This is the NotificationLoglRPNotifications:: NotifyLogSubscribed:: 
NOTIFY LOG SUBSRIBED. 


There is no 
corresponding IS 
parameter. 


event_name 


M 


Null-string 


There is no 
corresponding IS 
parameter. 


variable Header 






objectClass, 
objectlnstance 


One NV (note 1) pair 

of 

filterable_body_fields 


M 


Name of NV pair is the NotificationlRPConstDefs:: AttributeNameValue:: 
MANAGED_OBJECT_INSTANCE. 

Value of NV pair is a string. 


notificationid 


One NV pair of 
remaining_body 


M 


Name of NV pair is the NotificationlRPConstDefs:: AttributeNameValue:: 
NOTIFICATIONJD. 

Value of NV pair is a long. 


eventTlme 


One NV pair of 
filterable_body_fields 


M 


Name of NV pair is the NotificationlRPConstDefs:: AttributeNameValue:: 
EVENT_TIME. 

Value of NV pair is of type GenericlRPIVIanagementConstDefs::IRPTime. 


systemDN 


One NV pair of 
filterable_body_fields 


M 


Name of NV pair is the NotificationlRPConstDefs:: AttributeNameValue:: 
SYSTEM_DN 

Value of NV pair is a string. 


logSubscriptionld 


One NV pair of 
remaining_body 


M 


Name of NV pair is the NotificationLoglRPNotifications:: 
NotifyLogSubscribed::LOG_SUBSCRIPTION_ID. 

Value of NV pair is of type NotificationLoglRPConstDefs::LogSubscriptionld. 


loggingEndTime 


One NV pair of 
remaining_body 





Name of NV pair is the 
NotificationLoglRPNotifications::NotifyLogSubscribed::LOGGING_END_TIME. 

Value of NV pair is a string. 


notificationCategories 


One NV pair of 
remaining_body 





Name of NV pair is the NotificationLoglRPNotifications:: 
NotifyLogSubscribed::NOTIFICATION_CATEGORIES. 

Value of NV pair is of type 
GenericlRPManagementConstDefs::VersionNumberSet. 


filter 


One NV pair of 
remaining_body 





Name of NV pair is notificationLoglRPNotifications:: NotifyLogSubscribed:: 
FILTER 

Value of NV pair is a string. 


NOTE: NV stands for name-value pair. Order arrangement of NV pairs is not significant. The name of NV-pair is always encoded 
in string. This note is applicable to all NV-pairs and all mapping tables for all notifications. 
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Table 5.3.2: Mapping for notifyLogUnsubscribed 



IS Parameters 


OMG CORBA 

Structured Event 

attribute 


Qualifier 


Comment 


There is no 
corresponding IS 
parameter. 


domain_name 


M 


It carries the IRP document version number string. See 
sub-clause 3.3. 

It indicates the syntax and semantics of the Structured 
Event as defined by this specification. 


notificationType 


type_name 


M 


This is the NotificationLoglRPNotifications:: 
NotifyLogSubscribed:: NOTIFY LOG UNSUBSCRIBED. 


There is no 
corresponding IS 
parameter. 


event_name 


M 


Null-string. 


There is no 
corresponding IS 
parameter. 


variable Header 






objectClass, 
objectlnstance 


One NV pair of 
filterable_body_fields 


M 


Name of NV pair is the NotificationlRPConstDefs:: 
AttributeNameValue::MANAGED_OBJECT_INSTANCE. 

Value of NV pair is a string. 


notificationid 


One NV pair of 
remainingbody 


M 


Name of NV pair is the NotificationlRPConstDefs:: 
AttributeNameValue::NOTIFICATION_ID. 

Value of NV pair is a long. 


eventTime 


One NV pair of One NV 
pair of 
filterable_body_fields 


M 


Name of NV pair is the NotificationlRPConstDefs:: 
AttributeNameValue:: EVENT_TIME. 

Value of NV pair is a IRPTime of module 
GenericlRPManagementConstDefs. 


systemDN 


One NV pair of 
filterable_body_fields 


M 


Name of NV pair is the NotificationlRPConstDefs:: 
AttributeNameValue:: SYSTEM_DN 

Value of NV pair is a string. 


logSubscriptionld 


One NV pair of 
filterable_body_fields 
(editor note) 


M 


Name of NV pair is the NotificationLoglRPNotifications:: 
NotifyLogSubscribed:: LOG_SUBSCRIPTION_ID. 

Value of NV pair is of type 
NotificationLoglRPConstDefs::LogSubscriptionld. 



Editor note: The placement of this parameter in filterable_body_fields so that it is fiherable is not yet aligned with 
current IS and require further discussion. 
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Table 5.3.3: Mapping for notifyOccupancyLevelCrossed 



IS Parameters 


OMG CORBA 

Structured Event 

attribute 


Qualifier 


Comment 


There is no 
corresponding IS 
parameter. 


domain_name 


M 


It carries the IRP document version number string. See 
sub-clause 3.3. 

It indicates the syntax and semantics of the Structured 
Event as defined by this specification. 


notificationType 


type_name 


M 


This is the NotificationLoglRPNotifications:: 

NotifyLogSubscribed:: 

NOTIFY LOG OCCUPANCY LEVEL CROSSED. 


There is no 
corresponding IS 
parameter 


event_name 


M 


Null-string 


There is no 
corresponding IS 
parameter. 


variable Header 






objectClass, 
objectlnstance 


One NV pair of 
filterable_body_fields 


M 


NV stands for name-value pair. Order arrangement of NV 
pairs is not significant. The name of NV-pair is always 
encoded in string. 

Name of NV pair is the NotificationlRPConstDefs:: 
AttributeNameValue::MANAGED_OBJECT_INSTANCE. 

Value of NV pair is a string. 


notificationid 


One NV pair of 
remaining_body 


M 


Name of NV pair is the NotificationlRPConstDefs:: 
AttributeNameValue::NOTIFICATION_ID. 

Value of NV pair is a long. 


eventTime 


One NV pair of 
filterable_body_fields 


M 


Name of NV pair is the NotificationlRPConstDefs:: 
AttributeNameValue:: EVENT_TIME. 

Value of NV pair is a IRPTime of module 
Generic! RPManagementConstDefs. 


systemDN 


One NV pair of 
filterable_body_fields 


M 


Name of NV pair is the NotificationlRPConstDefs:: 
AttributeNameValue:: SYSTEM_DN 

Value of NV pair is a string. 


logSubscriptlonld 


One NV pair of 
filterable_body_fields 


M 


Name of NV pair is the NotificationLoglRPNotifications:: 
NotifyLogSubscribed:: LOG_SUBSCRIPTION_ID. 

Value of NV pair is of type 
NotificationLoglRPConstDefs::LogSubscriptionld. 


currentOccupancyLevel 


One NV pair of One NV 
pair of 
filterable_body_fields 


M 


Name of NV pair is the NotificationLoglRPNotifications:: 
NotifyLogSubscribed:: CURRENT_OCCUPANCY_LEVEL. 

Value of NV pair is an unsigned short (i.e. DsLogAdmin:: 
Threshold). 


logFullAction 


One NV pair of 
filterable_body_fields 


M 


Name of NV pair is the NotificationLoglRPNotifications:: 
NotifyLogSubscribed:: LOG_FULL_ACTION. 

Value of NV pair is of type NotificationLoglRPConstDefs:: 
LogFullActionType. 
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Table 5.3.4: Mapping for notifyLoggingResumed 



IS Parameters 


OMG CORBA 

Structured Event 

attribute 


Qualifier 


Comment 


There is no 
corresponding IS 
parameter. 


domain_name 


M 


It carries the IRP document version number string. See sub-clause 3.3. 
It indicates the syntax and semantics of the Structured Event as defined by 
this specification. 


notificationType 


type_name 


M 


This is the NotificationLoglRPNotifications:: NotifyLogSubscribed:: 
NOTIFY LOG SUBSRIBED. 


There is no 
corresponding IS 
parameter. 


event_name 


M 


Null-string 


There is no 
corresponding IS 
parameter. 


variable Header 






objectClass, 
objectlnstance 


One NV (note 1) pair 

of 

filterable_body_fields 


M 


Name of NV pair is the NotificationlRPConstDefs:; AttributeNameValue:: 
MANAGED_OBJECT_INSTANCE. 

Value of NV pair is a string. 


notificationid 


One NV pair of 
remaining_body 


M 


Name of NV pair is the NotificationlRPConstDefs:: AttributeNameValue:: 
NOTIFICATIONJD. 

Value of NV pair is a long. 


eventTlme 


One NV pair of 
filterable_body_fields 


M 


Name of NV pair Is the NotificationlRPConstDefs:: AttributeNameValue:: 
EVENT_TIME. 

Value of NV pair is of type GenericlRPManagementConstDefs::IRPTime. 


systemDN 


One NV pair of 
filterable_body_fields 


M 


Name of NV pair is the NotificationlRPConstDefs:: AttributeNameValue:: 
SYSTEM_DN 

Value of NV pair is a string. 


logSubscriptionld 


One NV pair of 
remaining_body 


M 


Name of NV pair is the NotificationLoglRPNotifications:: 
NotifyLogSubscribed::LOG_SUBSCRIPTION_ID. 

Value of NV pair is of type NotificationLoglRPConstDefs::LogSubscriptionld. 


loggingEndTime 


One NV pair of 
remaining_body 





Name of NV pair is the 
NotificationLoglRPNotifications::NotifyLogSubscribed::LOGGING_END_TIME. 

Value of NV pair is a string. 


notificationCategories 


One NV pair of 
remaining_body 





Name of NV pair is the NotificationLoglRPNotifications:: 
NotifyLogSubscribed::NOTIFICATION_CATEGORIES. 

Value of NV pair is of type 
GenericlRPManagementConstDefs::VersionNumberSet. 


filter 


One NV pair of 
remaining_body 





Name of NV pair is notificationLoglRPNotifications:: NotifyLogSubscribed:: 
FILTER 

Value of NV pair is a string. 


NOTE: NV stands for name-value pair. Order arrangement of NV pairs is not significant. The name of NV-pair is always encoded 
in string. This note is applicable to all NV-pairs and all mapping tables for all notifications. 
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6 NotificationLoglRPNotifications Interface 

OMG CORBA Notification push operation is used to realise the notification of 

Notif icationLoglRPNotif ications. All the notifications in this interface are implemented using this 

push_structured_event method. 

6.1 Method push (M) 

module CosNotifyComm { 

Interface SequencePushConsumer : NotifyPublish { 
void push_structured_events { 

in CosNotif ication: : EventBatch notifications) 

raises ( CosEventComm: : Disconnected) ; 



// SequencePushConsumer 



} ; // CosNotifyComm 

NOTE 1: The push_structured_events method takes an input parameter of type EventBatch as defined 
in the OMG CosNotif ication module (OMG Notification Service [1]). This data type is the same as 
a sequence of Structured Events. Upon invocation, this parameter will contain a sequence of Structured 
Events being delivered to IRPManager by IRP Agent to which it is connected. 

NOTE 2: The maximum number of events that will be transmitted within a single invocation of this operation is 
controlled by IRP Agent wide configuration parameter. 

NOTE 3: The amount of time the supplier (IRP Agent) of a sequence of Structured Events will accumulate 
individual events into the sequence before invoking this operation is controlled by IRP Agent wide 
configuration parameter as well. 

NOTE 4: IRP Agent may push EventBatch with only one Structured Event. 
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Annex A (normative): 
IDL specifications 

A.1 IDL specification (file name 

"NotificationLoglRPConstDefs.idl") 

// File: Notif icationLoglRPConstDef s . idl 

#ifndef _NOTIFICATIONLOGIRPCONSTDEFS_IDL_ 
#define _NOTIFICATIONLOGIRPCONSTDEFS_IDL_ 

#ifndef _DSLOGADMIN_IDL_ 
#define _DSLOGADMIN_IDL_ 
#include <DsLogAdmin. idl> 
#endif // _DSLOGADMIN_IDL_ 

#include "Notif icationlRPConstDefs . idl" 
#include "GenericIRPManagementConstDef s . idl" 

// This statement must appear after all include statements 
#pragma prefix "3gppsa5.org" 

module Notif icationLoglRPConstDef s 
{ 



typedef DsLogAdmin: 
typedef DsLogAdmin: 
typedef DsLogAdmin: 



Logid LogSubscriptionId; 
Recordid Recordld; 
RecordldList RecordldList ; 



typedef string LogManagerToken; 

/* 

LogManagerTokenOpt is a type carrying an optional parameter. 

If the boolean is TRUE, then the value is present; else absent. 

*/ 

union LogManagerTokenOpt switch (boolean) 

{ 

case TRUE: LogManagerToken value; 



/* 

IRPTimeOpt is a type carrying an optional parameter. 

If the boolean is TRUE, then the value is present; else absent. 

*/ 

union IRPTimeOpt switch (boolean) 

{ 

case TRUE: GenericIRPManagementConstDef s :: IRPTime value; 

}; 



typedef GenericIRPManagementConstDef s : : VersionNumberSet 

Notif icationCategorySet ; 
/* 

Notif icationCategorySetOpt is a type carrying an optional parameter. 
If the boolean is TRUE, then the value is present; else absent. 
*/ 
union Notif icationCategorySetOpt switch (boolean) 

{ 

case TRUE: Notif icationCategorySet value; 

}; 

enum LogState { LOGGING, LOGFULL, STOPPED}; 

typedef DsLogAdmin: : CapacityAlarmThresholdList 
CapacityAlarmThresholdList ; 

typedef unsigned short LogFullActionType; 
const LogFullActionType wrap = 0; 
const LogFullActionType halt = 1; 
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/* 

IteratorOpt is a type carrying an optional parameter. 

If the boolean is TRUE, then the value is present; else absent. 

*/ 

union IteratorOpt switch (boolean) 

{ 

case TRUE: DsLogAdmin :: Iterator value; 

}; 

struct LogAttributes { 

LogSubscriptionId logSubscriptionld; 

GenericIRPManagementConstDef s : : IRPTime loggingEndTime; 

unsigned long long maxSize; 

unsigned long long currentSize; 

LogState logState; 

unsigned long long logRecordCount ; 

Notif icationlRPConstDef s : iNotif icationCategorySet notif icationCategories; 

string filter; 

LogFullActionType logFullAction; 

CapacityAlarmThresholdList occupancyLevels ; 

}; 

typedef sequence <LogAttributes> LogAttributeList ; 



#endif // NOTIFICATIONLOGIRPCONSTDEFS_IDL_ 
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A.2 IDL specification (file name 'NotificationLoglRPSystem.idr) 

// File: Notif icationLoglRPSystem. idl 

#ifndef _NOTIFICATIONLOGIPRSYSTEM_IDL_ 
#define _NOTIFICATIONLOGIRPSYSTEM_IDL_ 

#include "Notif icationLoglRPConstDefs . idl" 

#include "GenericIRPManagementSystem. idl" 

#include <TimeBase . idl> 

#ifndef _DSLOGADMIN_IDL_ 

idefine _DSLOGADMIN_IDL_ 

#include <DsLogAdmin. idl> 

#endif // _DSLOGADMIN_IDL_ 

// This statement must appear after all include statements 
#pragma prefix "3gppsa5.org" 

module Notif icationLoglRPSystem 

{ 

/* 

System fails to complete the method. System can provide reason 

to qualify the exception. The semantics carried in reason 

is outside the scope of this IRP. 

*/ 

exception SubscribeLog { string reason; } ; 

exception UnsubscribeLog { string reason; }; 

exception ExportLogRecords { string reason; }; 

exception GetLogSubscriptionlds { string reason; }; 

exception GetLogRecords { string reason; }; 

exception GetLogSubscriptionStatus { string reason; }; 

exception InvalidLogSubscriptionId { string reason; }; 

exception UnknownLogSubscriptionId { } ; 

exception UnknownLogManagerToken { } ; 

exception InvalidConstraint { string reason; }; 



interface Notif icationLogIRP : GenericIRPManagementSystem: : 
Generic IRPManagement 

{ 

GenericIRPManagementConstDef s :: Signal subscribe_log { 

in Notif icationLoglRPConstDef s : :LogSubscriptionId logSubscriptionld, 
in Notif icationLoglRPConstDef s :: IRPTimeOpt loggingEndTimeAsked, 
in Notif icationLoglRPConstDef s : :Notif icationCategorySetOpt 

notif icationCategorySet , 
in GenericIRPManagementConstDef s :: StringOpt filter, 
out Notif icationLoglRPConstDef s : : LogSubscriptionld 

logSubscriptionldOut , 
out Notif icationLoglRPConstDef s : :LogManagerTokenOpt logManagerToken, 
out Notif icationLoglRPConstDef s :: IRPTimeOpt loggingEndTimeGiven 
) 
raises { SubscribeLog, 



GenericIRPManagementSystem : 
GenericIRPManagementSystem : 
GenericIRPManagementSystem : 
InvalidLogSubscriptionId, UnknownLogManagerToken 
) ; 



InvalidParameter, 

ParameterNotSupported, 

ValueNotSupported, 



GenericIRPManagementConstDef s :: Signal unsubscribe_log { 

in Notif icationLoglRPConstDef s : : LogSubscriptionld logSubscriptionld, 
in Notif icationLoglRPConstDef s : :LogManagerTokenOpt logManagerToken 
) 
raises { UnsubscribeLog, 

GenericIRPManagementSystem: : InvalidParameter, 
GenericIRPManagementSystem: : ParameterNotSupported, 
UnknownLogSubscriptionId, UnknownLogManagerToken) ; 

GenericIRPManagementConstDef s :: Signal export_log_records { 

in Notif icationLoglRPConstDef s : : LogSubscriptionld logSubscriptionld, 
in Notif icationLoglRPConstDef s : : Notif icationCategorySetOpt 

notif icationCategorySet , 
in GenericIRPManagementConstDef s :: StringOpt filter, 
out string invocationid 
) 
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raises ( ExportLogRecords, 

GenericIRPManagementSystem: 
GenericIRPManagementSystem: 
GenericIRPManagementSystem: 
UnknownLogSubscriptionId) ; 



InvalidParameter, 
ParameterNotSupported, 
OperationNot Supported, 



// If some but not all of the information is returned via the return value 

// RecordList, then the rest of the information is returned via the 

// iterator. Otherwise, the iterator is absent. 

// 
DsLogAdmin: : RecordList get_log_records { 

in Notif icationLoglRPConstDef s : iLogSubscriptionld logSubscriptionld, 
in Notif icationLoglRPConstDef s : : Notif icationCategorySetOpt 

notif icationCategories , 
in GenericIRPManagementConstDef s : : StringOpt filter, 
out Notif icationLoglRPConstDef s :: IteratorOpt iterator 
) 



raises { GetLogRecords, 

GenericIRPManagementSystem : 
GenericIRPManagementSystem: 
GenericIRPManagementSystem: 
GenericIRPManagementSystem: 
UnknownLogSubscriptionId) ; 



InvalidParameter, 
ParameterNotSupported, 
ValueNotSupported, 
OperationNot Supported, 



DsLogAdmin: :LogIdList get_log_subscription_ids { ) 
raises { GetLogSubscriptionlds, 

GenericIRPManagementSystem: :OperationNotSupported 
) ; 



GenericIRPManagementConstDef s : : Signal get_log_subscription_status { 

in Notif icationLoglRPConstDef s : : LogSubscriptionld logSubscriptionld, 

out Notif icationLoglRPConstDef s : :LogAttributeList logAttributeList 

) 

raises { GetLogSubscriptionStatus, 

GenericIRPManagementSystem: : InvalidParameter, 
GenericIRPManagementSystem: :OperationNotSupported 



) ; 



#endif // _NOTIFICATIONLOGIPRSYSTEM_IDL_ 
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A.3 IDL specification (file name 

'NotificationLoglRPNotifications.idI') 

// File: Notif icationLoglRPNotif ications . idl 

#ifndef _NOTIFICATIONLOGIRPNOTIFICATIONS_IDL_ 
idefine _NOTIFICATIONLOGIRPNOTIFICATIONS_IDL_ 

#include "Notif icationlRPNotif ications . idl" 

// This statement must appear after all include statements 
#pragma prefix "3gppsa5.org" 

module Notif icationLoglRPNotif ications 
{ 

interface Notif yLogSubscribed: Notif icationlRPNotif ications : iNotify 

{ 

const string NOTIFY_LOG_SUBSRIBED = "xl"; 

const string LOG_SUBSCRIPTION_ID = "id"; 

const string LOGGING_END_TIME = " loggingEndTime" ; 

const string NOTIFICATION_CATEGORIES = "categories"; 

const string FILTER = "filter"; 



interface Notif yLogUnubscribed: Notif icationlRPNotif ications : iNotify 

{ 

const string NOTIFY_LOG_UNSUBSCRIBED = "x2"; 

const string LOG_SUBSCRIPTION_ID = "id"; 

}; 

interface Notif yLogOccupancyLevelCrossed : 
Notif icationlRPNotif ications : iNotify 

{ 

const string NOTIFY_LOG_OCCUPANCY_LEVEL_CROSSED = "x3"; 

const string LOG_SUBSCRIPTION_ID = "id"; 

const string CURRENT_OCCUPANCY_LEVEL = "level"; 

const string LOG_FULL_ACTION = " fullAction" ; 



interface NotifyLoggingResumed: Notif icationlRPNotif ications : iNotify 

{ 

const string NOTIFY_LOGGING_RESUMED = "x4"; 

const string LOG_SUBSCRIPTION_ID = "id"; 



#endif // _NOTIFICATIONLOGIRPNOTIFICATIONS_IDL_ 
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